Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODTransform

GetMatrix

The GetMatrix method copies this transform's matrix into the specified structure.

void GetMatrix (out ODMatrix matrix);

matrix

The structure in which to return the matrix.

DISCUSSION

If you use transforms of the class ODTransform and you have also created a subclass of ODTransform that applies complex transformation effects that cannot be represented by matrices, your part needs to check whether a given transform has a matrix before calling this method. To do so, you should call the transform's HasMatrix method; only if that method returns true should you call the transform's GetMatrix method.

OVERRIDING

If you subclass ODTransform to create a nonlinear transform class, you must override this method. Your override method must not call its inherited method. Instead, it should raise a kODErrTransformErr exception. You can detect that a transform of your class has no matrix by calling its HasMatrix method.

EXCEPTION

kODErrTransformErr

This transform object does not use a matrix.

SEE ALSO

The ODMatrix type (page 888).
The ODTransform::HasMatrix method (page 772).
The ODTransform::SetMatrix method (page 783).
"Custom Transform Objects" on page 450 in OpenDoc Programmer's Guide.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help